home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 September / CHIP Eylül 1998.iso / Slackwar / docs / Serial-HOWTO < prev    next >
Text File  |  1997-07-06  |  66KB  |  1,513 lines
  1.   The Linux Serial HOWTO
  2.   by Greg Hankins, greg.hankins@cc.gatech.edu
  3.   v1.10, 6 July 1997
  4.  
  5.   This document describes how to set up serial communications devices
  6.   on a Linux box.
  7.  
  8.   1.  Introduction
  9.  
  10.   This is the Linux Serial HOWTO.  All about how to set up modems and
  11.   terminals under Linux, some serial tips, and troubleshooting.  This
  12.   HOWTO addresses Linux running on x86 hardware, although it might work
  13.   for other architectures.
  14.  
  15.   1.1.  Copyright
  16.  
  17.   The Linux Serial HOWTO is copyright (C) 1993 - 1997 by Greg Hankins.
  18.   Linux HOWTO documents may be reproduced and distributed in whole or in
  19.   part, in any medium physical or electronic, as long as this copyright
  20.   notice is retained on all copies. Commercial redistribution is allowed
  21.   and encouraged; however, the author would like to be notified of any
  22.   such distributions.
  23.  
  24.   All translations, derivative works, or aggregate works incorporating
  25.   any Linux HOWTO documents must be covered under this copyright notice.
  26.   That is, you may not produce a derivative work from a HOWTO and impose
  27.   additional restrictions on its distribution. Exceptions to these rules
  28.   may be granted under certain conditions; please contact the Linux
  29.   HOWTO coordinator at the address given below.
  30.  
  31.   In short, we wish to promote dissemination of this information through
  32.   as many channels as possible. However, we do wish to retain copyright
  33.   on the HOWTO documents, and would like to be notified of any plans
  34.   to redistribute the HOWTOs.
  35.  
  36.   If you have questions, please contact Greg Hankins, the Linux HOWTO
  37.   coordinator, at gregh@sunsite.unc.edu via email.
  38.  
  39.   1.2.  New Versions Of This Document
  40.  
  41.   New versions of the Serial HOWTO will be available at
  42.   ftp://sunsite.unc.edu:/pub/Linux/docs/HOWTO/Serial-HOWTO and mirror
  43.   sites.  There are other formats, such as PostScript and DVI versions
  44.   in the other-formats directory.  The Serial HOWTO is also available at
  45.   http://sunsite.unc.edu/LDP/HOWTO/Serial-HOWTO.html and will be posted
  46.   to comp.os.linux.answers monthly.
  47.  
  48.   1.3.  Feedback
  49.  
  50.   Please send me any questions, comments, suggestions, or additional
  51.   material.  I'm always eager to hear about what you think about the
  52.   HOWTO.  I'm also always on the lookout for improvements!  Tell me
  53.   exactly what you don't understand, or what could be clearer.  You can
  54.   reach me at greg.hankins@cc.gatech.edu via email.  All email will be
  55.   answered, although it may take me a week or so depending on how busy I
  56.   am.  I get a lot of email from root and misconfigured sites.  Please
  57.   send me email as a real person, and make sure that your email system
  58.   is working so that I will be able to reply to you.  If you don't hear
  59.   back from me within two weeks, please try sending your email again.
  60.  
  61.   I can also be reached at:
  62.   Greg Hankins
  63.   College of Computing
  64.   801 Atlantic Drive
  65.   Atlanta, GA 30332-0280
  66.   via snail mail, and at http://www.cc.gatech.edu/staff/h/Greg.Hankins/.
  67.  
  68.   Please include the version number of the Serial HOWTO when writing,
  69.   this is version 1.10.
  70.  
  71.   1.4.  Disclaimer
  72.  
  73.   Your mileage may vary.  The answers given may not work for all systems
  74.   and all setup combinations.
  75.  
  76.   2.  Supported Serial Hardware
  77.  
  78.   Linux is known to work with the following serial hardware.
  79.  
  80.   2.1.  Standard PC Serial Boards
  81.  
  82.   ╖  standard PC serial boards (COM1 - COM4), to which external serial
  83.      devices (modems, serial mice, etc...) can be connected
  84.  
  85.   ╖  standard PC internal modems (COM1 - COM4)
  86.  
  87.   ╖  Quickpath Systems Port-Folio 550e (allows IRQs of 3, 4, 5, 9, 10,
  88.      11, 12, and 15)
  89.  
  90.   Note: due to address conflicts, you cannot use COM4 and IBM8514 video
  91.   board simultaneously.  This is due to a bug in the IBM8514 board.
  92.  
  93.   2.2.  Plug And Play (PnP) Modems
  94.  
  95.   PnP modems will work with Linux.  However, I recommend against using
  96.   them because they are difficult.  There are a couple things you can
  97.   try;
  98.  
  99.   ╖  Try to disable the PnP features in the BIOS on your computer and
  100.      modem.
  101.  
  102.   ╖  Boot Win95, configure the modem, and see if the settings are
  103.      preserved when you boot Linux.  If not, then:
  104.  
  105.   ╖  Boot Win95, configure the modem, and then warm boot Linux so
  106.      that the settings are preserved.  You can do this with the loadlin
  107.      boot loader.
  108.  
  109.   ╖  Get the PnP tools from http://www.redhat.com/linux-info/pnp.
  110.  
  111.   ╖  And of course you can get a real modem.
  112.  
  113.   2.3.  Dumb Multiport Serial Boards (with 8250/16450/16550A UARTs)
  114.  
  115.   ╖  AST FourPort and clones (4 ports)
  116.  
  117.   ╖  Accent Async-4 (4 ports)
  118.  
  119.   ╖  Arnet Multiport-8 (8 ports)
  120.  
  121.   ╖  Bell Technologies HUB6 (6 ports)
  122.  
  123.   ╖  Boca BB-1004 (4 ports), BB-1008 (8 ports), BB-2016 (16 ports)
  124.  
  125.   ╖  Boca IOAT66 (6 ports)
  126.  
  127.   ╖  Boca 2by4 (4 serial ports, 2 parallel ports)
  128.  
  129.   ╖  Computone ValuePort V4-ISA (AST FourPort compatible)
  130.  
  131.   ╖  Digi PC/8 (8 ports)
  132.  
  133.   ╖  GTEK BBS-550 (8 ports)
  134.  
  135.   ╖  Longshine LCS-8880, Longshine LCS-8880+ (AST FourPort compatible)
  136.  
  137.   ╖  Moxa C104, Moxa C104+ (AST FourPort compatible)
  138.  
  139.   ╖  PC-COMM (4 ports)
  140.  
  141.   ╖  Sealevel Systems <http://www.sealevel.com> COMM-2 (2 ports), COMM-4
  142.      (4 ports) and COMM-8 (8 ports)
  143.  
  144.   ╖  SIIG I/O Expander 2S IO1812 (4 ports)
  145.  
  146.   ╖  STB-4COM (4 ports)
  147.  
  148.   ╖  Twincom ACI/550
  149.  
  150.   ╖  Usenet Serial Board II (4 ports)
  151.  
  152.   In general, Linux will support any serial board which uses a 8250,
  153.   16450, 16550, 16550A (or compatible) UART, or an internal modem which
  154.   emulates one of the above UARTs.
  155.  
  156.   Note: the BB-1004 and BB-1008 do not support DCD and RI lines, and
  157.   thus are not usable for dialin modems.  They will work fine for all
  158.   other purposes.
  159.  
  160.   2.4.  Intelligent Multiport Serial Boards
  161.  
  162.   ╖  Comtrol RocketPort (36MHz ASIC; 4, 8, 16 or 32 ports)
  163.      contact: info@comtrol.com or http://www.comtrol.com
  164.      driver status: supported by Comtrol
  165.      driver location: ftp://tsx-11.mit.edu/pub/linux/packages/comtrol
  166.  
  167.   ╖  Computone IntelliPort II (16MHz 80186; 4, 8, or 16 ports),
  168.      IntelliPort II EXpandable (20MHz 80186; 16 - 64 ports)
  169.      contact: Michael H. Warfield, mhw@wittsend.atl.ga.us
  170.      driver status: pre-ALPHA
  171.  
  172.   ╖  Cyclades Cyclom-Y (Cirrus Logic CD1400 UARTs; 8 - 32 ports),
  173.      Cyclom-Z (25MHz MIPS R3000; 8 - 128 ports)
  174.      contact: sales@cyclades.com or http://www.cyclades.com
  175.      driver status: supported by Cyclades
  176.      driver location: ftp://ftp.cyclades.com/pub/cyclades and included
  177.      in Linux kernel since version 1.1.75
  178.  
  179.   ╖  Decision PCCOM8 (8 ports)
  180.      contact: pccom8@signum.se
  181.      driver location: ftp://ftp.signum.se/pub/pccom8
  182.  
  183.   ╖  Digi PC/Xi (12.5MHz 80186; 4, 8, or 16 ports),
  184.      PC/Xe (12.5/16MHz 80186; 2, 4, or 8 ports),
  185.      PC/Xr (16MHz IDT3041; 4 or 8 ports),
  186.      PC/Xem (20MHz IDT3051; 8 - 64 ports)
  187.      contact: sales@dgii.com or http://www.dgii.com
  188.      driver status: supported by Digi
  189.      driver location: ftp://ftp.dgii.com/drivers/linux and included in
  190.      Linux kernel since version 2.0
  191.  
  192.   ╖  Digi COM/Xi (10MHz 80188; 4 or 8 ports)
  193.      contact: Simon Park, si@wimpol.demon.co.uk
  194.      driver status: ALPHA
  195.      note: Simon is often away from email for months at a time due to
  196.      his job.  Mark Hatle, fray@krypton.mankato.msus.edu has graciously
  197.      volunteered to make the driver available if you need it.  Mark is
  198.      not maintaining or supporting the driver.
  199.  
  200.   ╖  Equinox SuperSerial Technology (30MHz ASIC; 2 - 128 ports)
  201.      contact: sales@equinox.com or http://www.equinox.com
  202.      driver status: supported by Equinox
  203.      driver location: ftp://ftp.equinox.com/library/sst
  204.  
  205.   ╖  GTEK Cyclone (16C654 UARTs; 6, 16 and 32 ports),
  206.      SmartCard (24MHz Dallas DS80C320; 8 ports),
  207.      BlackBoard-8A (16C654 UARTs; 8 ports),
  208.      PCSS (15/24MHz 8032; 8 ports)
  209.      contact: spot@gtek.com or http://www.gtek.com
  210.      driver status: supported by GTEK
  211.      driver location: ftp://ftp.gtek.com/pub
  212.  
  213.   ╖  Hayes ESP (COM-bic; 1 - 8 ports)
  214.      contact: Andrew J. Robinson, arobinso@nyx.net or
  215.      http://www.nyx.net/~arobinso
  216.      driver status: supported by author
  217.      driver location: http://www.nyx.net/~arobinso and included in Linux
  218.      kernel since version 2.1.15
  219.  
  220.   ╖  Maxpeed SS (Toshiba; 4, 8 and 16 ports)
  221.      contact: info@maxpeed.com or http://www.maxpeed.com
  222.      driver status: supported by Maxpeed
  223.      driver location: ftp://maxpeed.com/pub/ss
  224.  
  225.   ╖  Moxa C218 (12MHz 80286; 8 ports),
  226.      Moxa C320 (40MHz TMS320; 8 - 32 ports)
  227.      contact: info@moxa.com.tw or http://www.moxa.com.tw
  228.      driver status: supported by Moxa
  229.      driver location: ftp://ftp.moxa.com.tw/drivers/c218-320/linux
  230.  
  231.   ╖  SDL RISCom/8 (Cirrus Logic CD180; 8 ports)
  232.      contact: sales@sdlcomm.com or http://www.sdlcomm.com
  233.      driver status: supported by SDL
  234.      driver location: ftp://ftp.sdlcomm.com/pub/drivers
  235.  
  236.   ╖  Specialix SIO (20MHz Zilog Z280; 4 - 32 ports),
  237.      XIO (25MHz Zilog Z280; 4 - 32 ports)
  238.      contact: Simon Allen, simonallen@cix.compulink.co.uk
  239.      driver status: BETA
  240.      driver location:
  241.      ftp://sunsite.unc.edu/pub/Linux/kernel/patches/serial
  242.  
  243.   ╖  Stallion EasyIO-4 (4 ports), EasyIO-8 (8 ports), and
  244.      EasyConnection (8 - 32 ports) - each with Cirrus Logic CD1400
  245.      UARTs,
  246.      Stallion (8MHz 80186 CPU; 8 or 16 ports),
  247.      Brumby (10/12 MHz 80186 CPU; 4, 8 or 16 ports),
  248.      ONboard (16MHz 80186 CPU; 4, 8, 12, 16 or 32 ports),
  249.      EasyConnection 8/64 (25MHz 80186 CPU; 8 - 64 ports)
  250.      contact: sales@stallion.com or http://www.stallion.com
  251.      driver status: supported by Stallion
  252.      driver location: ftp://ftp.stallion.com/drivers/ata5/Linux and
  253.      included in linux kernel since 1.3.27
  254.  
  255.   A review of Comtrol, Cyclades, Digi, and Stallion products was printed
  256.   in the June 1995 issue of the Linux Journal.  The article is available
  257.   at http://www.ssc.com/lj/issue14.
  258.  
  259.   2.5.  Unsupported Serial Hardware
  260.  
  261.   Modems that claim to be ``Winmodems'', for example the USR Sportster
  262.   Winmodem and IBM Aptiva MWAVE, are not supported under Linux.  These
  263.   modems use proprietary designs that require special Windows drivers.
  264.   Avoid these types of modems.  In addition, stay away from modems that
  265.   require Rockwell RPI drivers for the same reason.
  266.  
  267.   Intelligent serial boards that require drivers not available for Linux
  268.   won't work either.
  269.  
  270.   3.  What Are The Names Of The Serial Ports?
  271.  
  272.   An I/O port is a way to get data into and out of a computer.  There
  273.   are many types of I/O ports such as serial ports, parallel ports, disk
  274.   drive controllers, ethernet boards, etc.  We will be dealing with
  275.   serial ports since modems and terminals are serial devices.  Each
  276.   serial port must have an I/O address, and an interrupt (IRQ).  There
  277.   are the four serial ports corresponding to COM1 - COM4:
  278.  
  279.        ttyS0 (COM1) address 0x3f8 IRQ 4
  280.        ttyS1 (COM2) address 0x2f8 IRQ 3
  281.        ttyS2 (COM3) address 0x3e8 IRQ 4
  282.        ttyS3 (COM4) address 0x2e8 IRQ 3
  283.  
  284.   If Linux does not detect any serial ports when it boots, then make
  285.   sure that serial support is enabled and compiled into the kernel. In
  286.   this document, I refer to COM1 as ttyS0, COM2 as ttyS1, COM3 as ttyS2,
  287.   and COM4 as ttyS3.  Notice that by default these devices have overlap¡
  288.   ping IRQs.  You cannot use all of the ports in this default configura¡
  289.   tion, and you must reassign different IRQs.  See section ``Can I Use
  290.   More Than Two Serial Devices?'' on setting IRQs.
  291.  
  292.   On some installations, two extra devices will be created, /dev/modem
  293.   for your modem and /dev/mouse for your mouse.  Both of these are
  294.   symbolic links to the appropriate device in /dev which you specified
  295.   during the installation (unless you have a bus mouse, then /dev/mouse
  296.   will point to the bus mouse device).
  297.  
  298.   There has been some discussion on the merits of /dev/mouse and
  299.   /dev/modem.  I strongly discourage the use of these links.  In
  300.   particular, if you are planning on using your modem for dialin you may
  301.   run into problems because the lock files may not work correctly if you
  302.   use /dev/modem. Use them if you like, but be sure they point to the
  303.   right device.  However, if you change or remove this link, some
  304.   applications (minicom for example) might need reconfiguration.
  305.  
  306.   3.1.  Serial Port Devices and Numbers In /dev
  307.  
  308.        /dev/ttyS0 major 4, minor 64    /dev/cua0 major 5, minor 64
  309.        /dev/ttyS1 major 4, minor 65    /dev/cua1 major 5, minor 65
  310.        /dev/ttyS2 major 4, minor 66    /dev/cua2 major 5, minor 66
  311.        /dev/ttyS3 major 4, minor 67    /dev/cua3 major 5, minor 67
  312.  
  313.   Note that all distributions should come with these devices already
  314.   made correctly.  You can verify this by typing:
  315.  
  316.        linux% ls -l /dev/cua*
  317.        linux% ls -l /dev/ttyS*
  318.  
  319.   3.1.1.  Creating Devices In /dev
  320.  
  321.   If you don't have a device, you will have to create it with the mknod
  322.   command.  Example, suppose you needed to create devices for ttyS0:
  323.  
  324.        linux# mknod -m 666 /dev/cua0 c 5 64
  325.        linux# mknod -m 666 /dev/ttyS0 c 4 64
  326.  
  327.   You can use the MAKEDEV script, which lives in /dev.  This simplifies
  328.   the making of devices.  For example, if you needed to make the devices
  329.   for ttyS0 you would type:
  330.  
  331.        linux# cd /dev
  332.        linux# ./MAKEDEV ttyS0
  333.  
  334.   This handles the devices creation for the incoming and outgoing
  335.   devices, and should set the correct permissions.
  336.  
  337.   3.2.  Notes For Dumb Multiport Boards
  338.  
  339.   The devices your multiport board uses depends on what kind of board
  340.   you have.  These are listed in detail in rc.serial which comes with
  341.   the setserial program.  I highly recommend getting the latest version
  342.   of setserial if you are trying to use multiport boards.  You will
  343.   probably need to create these devices.  Either use the mknod command,
  344.   or the MAKEDEV script.  Devices for multiport boards are made by
  345.   adding ``64 + port number''.  So, if you wanted to create devices for
  346.   ttyS17, you would type:
  347.  
  348.        linux# mknod -m 666 /dev/cua17 c 5 81
  349.        linux# mknod -m 666 /dev/ttyS17 c 4 81
  350.  
  351.   Note that ``64 + 17 = 81''.  Using the MAKEDEV script, you would type:
  352.  
  353.        linux# cd /dev
  354.        linux# ./MAKEDEV ttyS17
  355.  
  356.   Note: the SIIG manual for the IO1812 listing for COM5-COM8 is wrong.
  357.   They should be COM5=0x250, COM6=0x258, COM7=0x260, and COM8=0x268.
  358.  
  359.   Note: the Digi PC/8 Interrupt Status Register is at 0x140.
  360.  
  361.   Note: for an AST Fourport, you might need to specify skip_test in
  362.   rc.serial.
  363.  
  364.   3.3.  Notes For Intelligent Multiport Boards
  365.  
  366.   Read the information that comes with the driver.  These boards use
  367.   special devices, and not the standard ones.  This information varies
  368.   depending on your hardware.
  369.  
  370.   4.  Interesting Programs You Should Know About
  371.  
  372.   4.1.  What is getty?
  373.  
  374.   getty is a program that handles the login process when you log onto a
  375.   Unix box.  You will need to use getty if you want to be able to dial
  376.   in to your Linux machine with a modem.  You do not need to use getty
  377.   if you only want to dial out with your modem.  There are three
  378.   versions that are commonly used with Linux: getty_ps, mgetty and
  379.   agetty.  The syntax for these programs differs, so be sure to check
  380.   and make sure that you are using the correct syntax         for
  381.   whatever getty you use.
  382.  
  383.   4.1.1.  About getty_ps
  384.  
  385.   Most distributions come with the getty_ps package installed.  It
  386.   contains two programs:  getty is used for console and terminal
  387.   devices, and uugetty for modems.  I use this version of getty, so that
  388.   is what I will focus on.
  389.  
  390.   4.1.2.  About mgetty
  391.  
  392.   mgetty is a version of getty for use with modems.  In addition to
  393.   allowing dialup logins, mgetty also provides FAX support and auto PPP
  394.   detection. The mgetty documentation is very good, and does not need
  395.   supplementing.  Please refer to it for installation instructions.  You
  396.   can find the latest information on mgetty at
  397.   http://www.leo.org/~doering/mgetty/.
  398.  
  399.   4.1.3.  About agetty
  400.  
  401.   agetty is the third variation of getty. It's a simple, completely
  402.   functional implementation of getty which is best suited for virtual
  403.   consoles or terminals rather than modems.
  404.  
  405.   4.2.  What is setserial?
  406.  
  407.   setserial is a program which allows you to look at and change various
  408.   attributes of a serial device, including its port address, its
  409.   interrupt, and other serial port options.  You can find out what
  410.   version you have by running setserial with no arguments.
  411.  
  412.   When your Linux system boots, only ttyS{0-3} are configured, using the
  413.   default IRQs of 4 and 3.  So, if you have any other serial ports
  414.   provided by other boards or if ttyS{0-3} have a non-standard IRQ, you
  415.   must use this program in order to configure those serial ports.  For
  416.   the full listing of options, consult the man page.
  417.  
  418.   5.  How Do I Dial Out With My Modem?
  419.  
  420.   5.1.  Hardware Requirements
  421.  
  422.   First, make sure you have the right cable.  Your modem requires a
  423.   straight through cable, with no pins crossed.  Any computer store
  424.   should have these.  Make sure you get the correct gender.  If you are
  425.   using the DB25 serial port, it will always be the male DB25.  Do not
  426.   confuse it with the parallel port, which is the female DB25.  Hook up
  427.   your modem to one of your serial ports.  Consult your modem manual on
  428.   how to do this if you need help.
  429.  
  430.   5.1.1.  Notes On Internal Modems
  431.  
  432.   For an internal modem, you will not need a cable.  An internal modem
  433.   does not need a serial port, it has one built in.  All you need to do
  434.   is configure it to use an interrupt that is not being used, and
  435.   configure the port I/O address.  Consult your modem manual if you get
  436.   stuck.  Also, see section ``Can I Use More Than   Two Serial
  437.   Devices?'' if you need help on choosing interrupts or addresses.
  438.  
  439.   On some motherboards you will have to disable the serial port that the
  440.   modem is replacing in order to avoid conflicts.  This may be done with
  441.   jumpers or in the BIOS settings, depending on your motherboard.
  442.   Consult your motherboard manual.
  443.  
  444.   Due to a bug in IBM8514 video boards, you may encounter problems if
  445.   you want your internal modem to be on ttyS3.  If Linux does not detect
  446.   your internal modem on ttyS3, you can use setserial and the modem will
  447.   work fine.  Internal modems on ttyS{0-2} should not have any problems
  448.   being detected.  Linux does not do any autoconfiguration on ttyS3 due
  449.   to this video board bug.
  450.  
  451.   5.2.  Talking To Your Modem
  452.  
  453.   Use kermit or some other communications program to test the setup,
  454.   before you go jumping into complex things SLIP or PPP.  You can find
  455.   the latest version of kermit at http://www.columbia.edu/kermit/.  For
  456.   example, say your modem was on ttyS3, and it's speed was 115200 bps.
  457.   You would do the following:
  458.  
  459.   linux# kermit
  460.   C-Kermit 6.0.192, 6 Sep 96, for Linux
  461.    Copyright (C) 1985, 1996,
  462.     Trustees of Columbia University in the City of New York.
  463.   Default file-transfer mode is BINARY
  464.   Type ? or HELP for help.
  465.   C-Kermit>set line /dev/ttyS3
  466.   C-Kermit>set carrier-watch off
  467.   C-Kermit>set speed 115200
  468.   /dev/ttyS3, 115200 bps
  469.   C-Kermit>c
  470.   Connecting to /dev/ttyS3, speed 115200.
  471.   The escape character is Ctrl-\ (ASCII 28, FS)
  472.   Type the escape character followed by C to get back,
  473.   or followed by ? to see other options.
  474.   ATE1Q0V1                           ; you type this and then the Enter key
  475.   OK                                 ; modem should respond with this
  476.  
  477.   If your modem responds to AT commands, you can assume your modem is
  478.   working correctly on the Linux side.  Now try calling another modem by
  479.   typing:
  480.  
  481.        ATDT7654321
  482.  
  483.   where 7654321 is a phone number.  Use ATDP instead of ATDT if you have
  484.   a pulse line.  If the call goes through, your modem is working.
  485.  
  486.   To get back to the kermit prompt, hold down the Ctrl key, press the
  487.   backslash key, then let go of the Ctrl key, then press the C key:
  488.  
  489.        Ctrl-\-C
  490.        (Back at linux)
  491.        C-Kermit>quit
  492.        linux#
  493.  
  494.   This was just a test using the primitive "by-hand" dialing method.
  495.   The normal method is to let kermit do the dialing for you with its
  496.   built-in modem database and automatic dialing features, for example
  497.   using a US Robotics (USR) modem:
  498.  
  499.   linux# kermit
  500.   C-Kermit 6.0.192, 6 Sep 1997, for Linux
  501.    Copyright (C) 1985, 1996,
  502.     Trustees of Columbia University in the City of New York.
  503.   Default file-transfer mode is BINARY
  504.   Type ? or HELP for help
  505.   C-Kermit>set modem type usr        ; Select modem type
  506.   C-Kermit>set line /dev/ttyS3       ; Select communication device
  507.   C-Kermit>set speed 115200          ; Set the dialing speed
  508.   C-Kermit>dial 7654321              ; Dial
  509.    Number: 7654321
  510.    Device=/dev/ttyS3, modem=usr, speed=115200
  511.    Call completed.<BEEP>
  512.   Connecting to /dev/ttyS3, speed 115200
  513.   The escape character is Ctrl-\ (ASCII 28, FS).
  514.   Type the escape character followed by C to get back,
  515.   or followed by ? to see other options.
  516.  
  517.   Welcome to ...
  518.  
  519.   login:
  520.  
  521.   See section ``Communications Programs'' about communications programs
  522.   if you need some pointers.
  523.  
  524.   When you dial out with your modem, set the speed to the highest bps
  525.   rate that your modem supports.  Versions of Linux with a libc version
  526.   greater then 5.x have support for speeds up to 115200 bps.  libc
  527.   usually lives in /lib, so look there for what version you have.  If
  528.   Linux does not recognize a speed of 57600 or 115200 bps, then you must
  529.   use the setserial program to set your serial port to a higher speed.
  530.   See section ``How Do I Set Up My Serial Ports For Higher Speeds?'' for
  531.   how to do this.  Then, set the speed to 38400 bps in your comm
  532.   program.
  533.  
  534.   5.3.  Dial Out Modem Configuration
  535.  
  536.   For dial out use only, you can configure your modem however you want.
  537.   If you intend to use your modem for dialin, you must configure your
  538.   modem at the same speed that you intend to run getty at.  So, if you
  539.   want to run getty at 38400 bps, set your speed to 38400 bps when you
  540.   configure your modem.  This is done to prevent speed mismatches
  541.   between your computer and modem.  In general, factory defaults that
  542.   enable error correction and hardware flow control are the best setting
  543.   for dial out modems, consult your modem manual for these settings.
  544.  
  545.   5.4.  Hardware Flow Control
  546.  
  547.   If your modem supports hardware flow control (RTS/CTS), I highly
  548.   recommend you use it. This is particularly important for modems that
  549.   support data compression.  First, you have to enable RTS/CTS flow
  550.   control on the serial port itself.  This is best done on startup, like
  551.   in /etc/rc.d/rc.local or /etc/rc.d/rc.serial.  Make sure that these
  552.   files are being run from the main rc.sysinit file!  You need to do the
  553.   following for each serial port you want to enable hardware flow
  554.   control on:
  555.  
  556.        stty crtscts < /dev/ttyS3
  557.  
  558.   You must also enable RTS/CTS flow control on your modem.  Consult your
  559.   modem manual on how to do this, as it varies between modem manufactur¡
  560.   ers.  Be sure to save your modem configuration if your modem supports
  561.   stored profiles.
  562.  
  563.   6.  How Do I Dial In And Out With My Modem Using getty_ps?
  564.  
  565.   Get your modem to dial out correctly.  If you haven't read section
  566.   ``How Do I Dial Out With My Modem'' go read it now!  It contains very
  567.   important setup information.  You do not need to read this section if
  568.   you only want to dial out with your modem.
  569.  
  570.   6.1.  Dial In And Out Modem Configuration
  571.  
  572.   For dialin and dialout use, you have to set up your modem a certain
  573.   way (again, using AT commands on your modem):
  574.  
  575.        E1       command echo ON
  576.        Q0       result codes are reported
  577.        V1       verbose ON
  578.        S0=0     never answer (uugetty handles this with the WAITFOR option)
  579.  
  580.   If you don't set these correctly, your INIT string in your config file
  581.   may fail, hosing the whole process.  But, more on config files
  582.   below...
  583.  
  584.        &C1     DCD is on after connect only
  585.        &S0     DSR is always on
  586.                DTR on/off resets modem (depends on manufacturer - RTFM)
  587.  
  588.   These affect what your modem does when calls start and end.
  589.  
  590.   If your modem does not support a stored profile, you can set these
  591.   through the INIT string in your config file.  See below.  Some modems
  592.   come with DIP switches that affect register settings.  Be sure these
  593.   are set correctly, too.
  594.  
  595.   I have started a collection of modem setups for different types of
  596.   modems.  So far, I only have a few of them, if you would like to send
  597.   me your working configuration, please do so!  You can get them at
  598.   ftp://ftp.cc.gatech.edu/pub/people/gregh/modem-configs.
  599.  
  600.   Note: to get my USR Courier V.34 modem to reset correctly when DTR
  601.   drops, I had to set &D2 and S13=1 (this sets bit 0 of register S13).
  602.   This has been confirmed to work on USR Sportster V.34 modems as well.
  603.  
  604.   Note: some Supra modems treat DCD differently than other modems.  If
  605.   you are using a Supra, try setting &C0 and not &C1.  You must also set
  606.   &D2 to handle DTR correctly.
  607.  
  608.   6.2.  Installing getty_ps
  609.  
  610.   Get the latest version from sunsite.unc.edu:/pub/Linux/system/serial.
  611.   In particular, if you want to use high speeds (57600 and 115200 bps),
  612.   you must get version 2.0.7j or later.  You must also have libc 5.x or
  613.   greater.
  614.  
  615.   By default, getty_ps will be configured to be Linux FSSTND (File
  616.   System Standard) compliant, which means that the binaries will be in
  617.   /sbin, and the config files will be named /etc/conf.{uu}getty.ttySN.
  618.   This is not apparent from the documentation!  It will also expect lock
  619.   files to go in /var/lock.  Make sure you have the /var/lock directory.
  620.  
  621.   If you don't want FSSTND compliance, binaries will go in /etc, config
  622.   files will go in /etc/default/{uu}getty.ttySN, and lock files will go
  623.   in /usr/spool/uucp.  I recommend doing things this way if you are
  624.   using UUCP, because UUCP will have problems if you move the lock files
  625.   to where it isn't looking for them.
  626.  
  627.   getty_ps can also use syslogd to log messages.  See the man pages for
  628.   syslogd(1) and syslog.conf(5) for setting up syslogd, if you don't
  629.   have it running already.  Messages are logged with priority LOG_AUTH,
  630.   errors use LOG_ERR, and debugging uses LOG_DEBUG.  If you don't want
  631.   to use syslogd you can edit tune.h in the getty_ps source files to use
  632.   a log file for messages instead, namely /var/adm/getty.log by default.
  633.  
  634.   Decide on if you want FSSTND compliance and syslog capability.  You
  635.   can also choose a combination of the two.  Edit the Makefile, tune.h
  636.   and config.h to reflect your decisions.  Then compile and install
  637.   according to the instructions included with the package.
  638.  
  639.   From this point on, all references to getty will refer to getty_ps.
  640.   References to uugetty will refer to the uugetty that comes with the
  641.   getty_ps package.  These instructions will not work for mgetty or
  642.   agetty.
  643.  
  644.   6.3.  Setting up uugetty
  645.  
  646.   For dialing into, and out from your modem, we want to use uugetty.
  647.   uugetty does important lock file checking.  Update /etc/gettydefs to
  648.   include entries for modems if they aren't already there (note that the
  649.   entries point to each other, these are not         for fixed speed -
  650.   blank lines are needed between each entry):
  651.  
  652.        # Modem entries
  653.        115200# B115200 CS8 # B115200 SANE -ISTRIP HUPCL #@S @L @B login: #57600
  654.  
  655.        57600# B57600 CS8 # B57600 SANE -ISTRIP HUPCL #@S @L @B login: #38400
  656.  
  657.        38400# B38400 CS8 # B38400 SANE -ISTRIP HUPCL #@S @L @B login: #19200
  658.  
  659.        19200# B19200 CS8 # B19200 SANE -ISTRIP HUPCL #@S @L @B login: #9600
  660.  
  661.        9600# B9600 CS8 # B9600 SANE -ISTRIP HUPCL #@S @L @B login: #2400
  662.  
  663.        2400# B2400 CS8 # B2400 SANE -ISTRIP HUPCL #@S @L @B login: #115200
  664.  
  665.   If you have a 9600 bps or faster modem with data compression, you can
  666.   lock your serial port speed and let the modem handle the transitions
  667.   to other speeds. Then, instead of the step down series of lines listed
  668.   above /etc/gettydefs only needs to contain one line for the modem, for
  669.   example:
  670.  
  671.        # 115200 fixed speed
  672.        F115200# B115200 CS8 # B115200 SANE -ISTRIP HUPCL #@S @L @B login: #F115200
  673.  
  674.   If you have your modem set up to do RTS/CTS hardware flow control, you
  675.   can add CRTSCTS to the entries:
  676.  
  677.        # 115200 fixed speed with hardware flow control
  678.        F115200# B115200 CS8 CRTSCTS # B115200 SANE -ISTRIP HUPCL CRTSCTS #@S @L @B login: #F115200
  679.  
  680.   If you want, you can make uugetty print interesting things in the
  681.   login banner.  In my examples, I have the system name, the serial
  682.   line, and the current bps rate.  You can add other things:
  683.  
  684.               @B    The current (evaluated at the time the @B is seen) bps rate.
  685.               @D    The current date, in MM/DD/YY.
  686.               @L    The serial line to which getty is attached.
  687.               @S    The system name.
  688.               @T    The current time, in HH:MM:SS (24-hour).
  689.               @U    The number of currently signed-on users.  This is  a
  690.                     count of the number of entries in the /etc/utmp file
  691.                     that have a non-null ut_name field.
  692.               @V    The value of VERSION, as given in the defaults file.
  693.               To display a single '@' character, use either '\@' or '@@'.
  694.  
  695.   Next, make sure that you have an outgoing and incoming device for the
  696.   serial port your modem is on.  If you have your modem on ttyS3 you
  697.   will need the /dev/cua3, and /dev/ttyS3 devices.  If you don't have
  698.   the correct devices, see section ``Creating Devices In <TT>/dev</TT>''
  699.   on how to create devices, and create the devices.  If you want to be
  700.   able to dial out with your modem while uugetty is watching the port
  701.   for logins, use the /dev/cuaN device instead of the /dev/ttySN device.
  702.  
  703.   When you are done editing /etc/gettydefs, you can verify that the
  704.   syntax is correct by doing:
  705.  
  706.        linux# getty -c /etc/gettydefs
  707.  
  708.   6.4.  Customizing uugetty
  709.  
  710.   There are lots of parameters you can tweak for each port you have.
  711.   These are implemented in separate config files for each port.  The
  712.   file /etc/conf.uugetty will be used by all instances of uugetty, and
  713.   /etc/conf.uugetty.ttySN will only be used by that one port.  Sample
  714.   default config files can be found with the getty_ps source files,
  715.   which come with most Linux distributions.  Due to space concerns, they
  716.   are not listed here.  Note that if you are using older versions of
  717.   getty (older than 2.0.7e), or aren't using FSSTND, then the default
  718.   file will be /etc/default/uugetty.ttySN.  My /etc/conf.uugetty.ttyS3
  719.   looks like this:
  720.  
  721.        # sample uugetty configuration file for a Hayes compatible modem to allow
  722.        # incoming modem connections
  723.        #
  724.        # alternate lock file to check... if this lock file exists, then uugetty is
  725.        # restarted so that the modem is re-initialized
  726.        ALTLOCK=cua3
  727.        ALTLINE=cua3
  728.        # line to initialize
  729.        INITLINE=cua3
  730.        # timeout to disconnect if idle...
  731.        TIMEOUT=60
  732.        # modem initialization string...
  733.        # format: <expect> <send> ... (chat sequence)
  734.        INIT="" AT\r OK\r\n
  735.        WAITFOR=RING
  736.        CONNECT="" ATA\r CONNECT\s\A
  737.        # this line sets the time to delay before sending the login banner
  738.        DELAY=1
  739.        #DEBUG=010
  740.  
  741.   Add the following line to your /etc/inittab, so that uugetty is run on
  742.   your serial port (substituting in the correct information for your
  743.   environment - config file location, port, speed, and default terminal
  744.   type):
  745.  
  746.        S3:456:respawn:/sbin/uugetty -d /etc/default/uugetty.ttyS3 ttyS3 F115200 vt100
  747.  
  748.   Restart init:
  749.  
  750.        linux# init q
  751.  
  752.   For the speed parameter in your /etc/inittab, you want to use the
  753.   highest bps rate that your modem supports.
  754.  
  755.   Now Linux will be watching your serial port for connections.  Dial in
  756.   from another machine and login to you Linux system.
  757.  
  758.   uugetty has a lot more options, see the man page for getty(1m) for a
  759.   full description.  Among other things there is a scheduling feature,
  760.   and a ringback feature.
  761.  
  762.   7.  How Do I Set Up A Terminal Connected To My PC?
  763.  
  764.   The instructions in this section will work for connecting terminals,
  765.   as well as other computers to the serial port on your Linux box.
  766.  
  767.   7.1.  Hardware Requirements
  768.  
  769.   Make sure you have the right kind of cable.  A null modem cable bought
  770.   at a computer store will do it.  But it must be a null modem cable!
  771.   Many computer stores advertise this kind of cable as a serial printer
  772.   cable.  Make sure you are using your serial port, the male DB25 or the
  773.   DB9, and not your parallel port (female DB25 or centronics).
  774.  
  775.   For a DB25 connector, you need a minimum of:
  776.  
  777.           PC male DB25                            Terminal DB25
  778.           TxD   Transmit Data         2 --> 3     RxD   Receive Data
  779.           RxD   Receive Data          3 <-- 2     TxD   Transmit Data
  780.           SG    Signal Ground         7 --- 7     SG    Signal Ground
  781.  
  782.   If you want to have hardware handshaking signals, you must have a full
  783.   null modem cable:
  784.  
  785.           PC male DB25                            Terminal DB25
  786.           TxD   Transmit Data         2 --> 3     RxD   Receive Data
  787.           RxD   Receive Data          3 <-- 2     TxD   Transmit Data
  788.           RTS   Request To Send       4 --> 5     CTS   Clear To Send
  789.           CTS   Clear To Send         5 <-- 4     RTS   Request To Send
  790.           DSR   Data Set Ready        6
  791.                                       |
  792.           DCD   Carrier Detect        8 <-- 20    DTR   Data Terminal Ready
  793.           SG    Signal Ground         7 --- 7     SG    Signal Ground
  794.                                             6     DSR   Data Set Ready
  795.                                             |
  796.           DTR   Data Terminal Ready  20 --> 8     DCD   Carrier Detect
  797.  
  798.   If you have a DB9 connector on your serial port, try the following:
  799.  
  800.           PC DB9                                  Terminal DB25
  801.           RxD   Receive Data          2 <-- 2     TxD   Transmit Data
  802.           TxD   Transmit Data         3 --> 3     RxD   Receive Data
  803.           SG    Signal Ground         5 --- 7     SG    Signal Ground
  804.  
  805.   Alternatively, a full DB9-DB25 null modem cable:
  806.  
  807.           PC DB9                                  Terminal DB25
  808.           RxD   Receive Data          2 <-- 2     TxD   Transmit Data
  809.           TxD   Transmit Data         3 --> 3     RxD   Receive Data
  810.                                             6     DSR   Data Set Ready
  811.                                             |
  812.           DTR   Data Terminal Ready   4 --> 8     DCD   Carrier Detect
  813.           GND   Signal Ground         5 --- 7     GND   Signal Ground
  814.           DCD   Carrier Detect        1
  815.                                       |
  816.           DSR   Data Set Ready        6 <-- 20    DTR   Data Terminal Ready
  817.           RTS   Request To Send       7 --> 5     CTS   Clear To Send
  818.           CTS   Clear To Send         8 <-- 4     RTS   Request To Send
  819.           (RI   Ring Indicator        9 not needed)
  820.  
  821.   (Yes, the pins 2 and 3 really do have the opposite meanings in DB9
  822.   connectors than in DB25 connectors!)
  823.  
  824.   If you are not using a full null modem cable, you might have to do the
  825.   following trick: on your computer side of the connector, connect RTS
  826.   and CTS together, and also connect DSR, DCD and DTR together.  This
  827.   way, when the computer wants a certain handshaking signal, it will get
  828.   it (from itself).
  829.  
  830.   Now that you have the right kind of cable, connect your terminal to
  831.   your computer.  If you can, tell the terminal to ignore modem control
  832.   signals.  Try using 9600 bps, 8 data bits, 1 stop bit, no parity bits
  833.   for the terminal's setup.
  834.  
  835.   7.2.  Setting up getty
  836.  
  837.   Add entries for getty to use for your terminal in /etc/gettydefs if
  838.   there they aren't already there:
  839.  
  840.        # 38400 bps Dumb Terminal entry
  841.        DT38400# B38400 CS8 CLOCAL # B38400 SANE -ISTRIP CLOCAL #@S @L login: #DT38400
  842.  
  843.        # 19200 bps Dumb Terminal entry
  844.        DT19200# B19200 CS8 CLOCAL # B19200 SANE -ISTRIP CLOCAL #@S @L login: #DT19200
  845.  
  846.        # 9600 bps Dumb Terminal entry
  847.        DT9600# B9600 CS8 CLOCAL # B9600 SANE -ISTRIP CLOCAL #@S @L login: #DT9600
  848.  
  849.   If you want, you can make getty print interesting things in the login
  850.   banner.  In my examples, I have the system name and the serial line
  851.   printed.  You can add other things:
  852.  
  853.        @B    The current (evaluated at the time the @B is seen) bps rate.
  854.        @D    The current date, in MM/DD/YY.
  855.        @L    The serial line to which getty is attached.
  856.        @S    The system name.
  857.        @T    The current time, in HH:MM:SS (24-hour).
  858.        @U    The number of currently signed-on users.  This is  a
  859.              count of the number of entries in the /etc/utmp file
  860.              that have a non-null ut_name field.
  861.        @V    The value of VERSION, as given in the defaults file.
  862.        To display a single '@' character, use either '\@' or '@@'.
  863.  
  864.   When you are done editing /etc/gettydefs, you can verify that the
  865.   syntax is correct by doing:
  866.  
  867.        linux# getty -c /etc/gettydefs
  868.  
  869.   Make sure there is no getty or uugetty config file for the serial port
  870.   that your terminal is attached to (/etc/default/{uu}getty.ttySN or
  871.   /etc/conf.{uu}getty.ttySN), as this will probably interfere with
  872.   running getty on a terminal.  Remove the file if it exits.
  873.  
  874.   Edit your /etc/inittab file to run getty on the serial port
  875.   (substituting in the correct information for your environment - port,
  876.   speed, and default terminal type):
  877.  
  878.        S1:456:respawn:/sbin/getty ttyS1 DT9600 vt100
  879.  
  880.   Restart init:
  881.  
  882.        linux# init q
  883.  
  884.   At this point, you should see a login prompt on your terminal.  You
  885.   may have to hit return to get the terminal's attention.
  886.  
  887.   7.3.  Notes On Setting Up A PC As A Terminal
  888.  
  889.   Many people set up other PCs as terminals connected to Linux boxen.
  890.   For example, old 8088 or 80286 PCs are perfect for this purpose.  All
  891.   you need is a DOS boot disk containing a version of DOS suitable for
  892.   your terminal-PC, and a communications program for your terminal-PC to
  893.   run.  kermit works very well for this purpose.  You can find
  894.   precompiled versions of kermit for every OS in existence at
  895.   http://www.columbia.edu/kermit/.  Other popular DOS comm programs such
  896.   as telix and procomm will work equally well.  Be sure to input correct
  897.   serial port information into your terminal-PC's communications setup.
  898.  
  899.   8.  Can I Use More Than Two Serial Devices?
  900.  
  901.   You don't need to read this section, unless you want to use three or
  902.   more serial devices... (assuming you don't have a multiport board).
  903.  
  904.   Providing you have another spare serial port, yes you can.  The number
  905.   of serial ports you can use is limited by the number of interrupts
  906.   (IRQs) and port I/O addresses we have to use.  This is not a Linux
  907.   limitation, but a limitation of the PC bus.  Each serial devices must
  908.   be assigned it's own interrupt and address.  A serial device can be a
  909.   serial port, an internal modem, or a multiport serial board.
  910.  
  911.   Multiport serial boards are specially designed to have multiple serial
  912.   ports that share the same IRQ for all serial ports on the board.
  913.   Linux gets data from them by using a different I/O address for each
  914.   port on the board.
  915.  
  916.   8.1.  Choosing Serial Device Interrupts
  917.  
  918.   Your PC will normally come with ttyS0 and ttyS2 at IRQ 4, and ttyS1
  919.   and ttyS3 at IRQ 3.  You can see what IRQs are in use by looking at
  920.   /proc/interrupts.  To use more than two serial devices, you will have
  921.   to reassign an interrupt.  A good choice is to reassign an interrupt
  922.   from your parallel port.  Your PC normally comes with IRQ 5 and IRQ 7
  923.   set up as interrupts for your parallel ports, but few people use two
  924.   parallel ports.  You can reassign one of the interrupts to a serial
  925.   device, and still happily use a parallel port.  You will need the
  926.   setserial program to do this.  In addition, you have to play with the
  927.   jumpers on your boards, check the docs for your board.  Set the
  928.   jumpers to the IRQ you want for each port.
  929.  
  930.   You will need to set things up so that there is one, and only one
  931.   interrupt for each serial device.  Here is how I set mine up in
  932.   /etc/rc.d/rc.local - you should do it upon startup somewhere:
  933.  
  934.                /sbin/setserial /dev/ttyS0 irq 3        # my serial mouse
  935.                /sbin/setserial /dev/ttyS1 irq 4        # my Wyse dumb terminal
  936.                /sbin/setserial /dev/ttyS2 irq 5        # my Zoom modem
  937.                /sbin/setserial /dev/ttyS3 irq 9        # my USR modem
  938.  
  939.   Standard IRQ assignments:
  940.  
  941.                 IRQ  0    Timer channel 0
  942.                 IRQ  1    Keyboard
  943.                 IRQ  2    Cascade for controller 2
  944.                 IRQ  3    Serial port 2
  945.                 IRQ  4    Serial port 1
  946.                 IRQ  5    Parallel port 2
  947.                 IRQ  6    Floppy diskette
  948.                 IRQ  7    Parallel port 1
  949.                 IRQ  8    Real-time clock
  950.                 IRQ  9    Redirected to IRQ2
  951.                 IRQ 10    not assigned
  952.                 IRQ 11    not assigned
  953.                 IRQ 12    not assigned
  954.                 IRQ 13    Math coprocessor
  955.                 IRQ 14    Hard disk controller 1
  956.                 IRQ 15    Hard disk controller 2
  957.  
  958.   There is really no Right Thing to do when choosing interrupts.  Just
  959.   make sure it isn't being used by the motherboard, or any other boards.
  960.   2, 3, 4, 5, or 7  is a good choice.  ``not assigned'' means that
  961.   currently nothing standard uses these IRQs.  Also note that IRQ 2 is
  962.   the same as IRQ 9.  You can call it either 2 or 9, the serial driver
  963.   is very understanding.  If you have a serial board with a 16-bit bus
  964.   connector, you can also use IRQ 10, 11, 12 or 15.
  965.  
  966.   Just make sure you don't use IRQ 0, 1, 6, 8, 13 or 14!  These are used
  967.   by your mother board.  You will make her very unhappy by taking her
  968.   IRQs.  When you are done, double-check /proc/interrupts and make sure
  969.   there are no conflicts.
  970.  
  971.   8.2.  Setting Serial Device Addresses
  972.  
  973.   Next, you must set the port address.  Check the manual on your board
  974.   for the jumper settings.  Like interrupts, there can only be one
  975.   serial device at each address.  Your ports will usually come
  976.   configured as follows:
  977.  
  978.                ttyS0 address 0x3f8
  979.                ttyS1 address 0x2f8
  980.                ttyS2 address 0x3e8
  981.                ttyS3 address 0x2e8
  982.  
  983.   Choose which address you want each serial device to have and set the
  984.   jumpers accordingly.  I have my modem on ttyS3, my mouse on ttyS0, and
  985.   my terminal on ttyS2.
  986.  
  987.   When you reboot, Linux should see your serial ports at the address you
  988.   set them.  The IRQ Linux sees may not correspond to the IRQ you set
  989.   with the jumpers.  Don't worry about this.  Linux does not do any IRQ
  990.   detection when it boots, because IRQ detection is dicy and can be
  991.   fooled.  Use setserial to tell Linux what IRQ the port is using.  You
  992.   can check /proc/ioports to see what I/O port addresses are in use
  993.   after Linux boots.
  994.  
  995.   9.  How Do I Set Up My Serial Ports For Higher Speeds?  What Speed
  996.   Should I Use With My Modem?
  997.  
  998.   This section should help you figure out what speed to use when using
  999.   your modem with a communications program, or with a getty program.
  1000.  
  1001.   ╖  If you have something slower than a 9600 bps (V.32) modem, set your
  1002.      speed to the highest speed your modem supports.  For example 300
  1003.      bps (V.21/Bell 103), 1200 bps (V.22/Bell 212A), or 2400 bps
  1004.      (V.22bis).
  1005.  
  1006.   ╖  If you have a 9600 bps (V.32) modem, with V.42bis data compression,
  1007.      use 38400 bps as your speed.  V.42bis compression has a theoretical
  1008.      rate of 4:1, thus ``4 * 9600 = 38400''.
  1009.  
  1010.   ╖  If you have a 14400 bps (V.32bis) modem, with V.42bis data
  1011.      compression, use setserial with the spd_hi flag to configure your
  1012.      serial port to use 57600 bps (4 * 14400 = 57600).
  1013.  
  1014.      Use the spd_vhi flag if you have a 28800 or 33600 bps (V.FC or
  1015.      V.34) modem (4 * 28800 = 115200).
  1016.  
  1017.      Then, use 38400 bps as the speed in your communication program, or
  1018.      /etc/inittab.  This is now the high speed you have set.  Make sure
  1019.      you have 16550A UARTs.
  1020.  
  1021.      If your libc version is at least 5.x, there will be speeds named
  1022.      57600 and 115200.  libc lives in /lib, so look there for what
  1023.      version you have.  You can use these directly (without using
  1024.      setserial), if your applications have been compiled to take
  1025.      advantage of this.  There are many distributions out there, so the
  1026.      best thing to do would be to try using these higher speeds if you
  1027.      have a recent version of a Linux distribution.
  1028.  
  1029.   Test your setserial setting on the command line first, and then when
  1030.   you have them working, put them into /etc/rc.d/rc.serial or
  1031.   /etc/rc.d/rc.local so that they are done at startup.  In my
  1032.   /etc/rc.d/rc.local, I set ttyS3 to 115200 bps by doing:
  1033.  
  1034.        /sbin/setserial /dev/ttyS3 spd_vhi
  1035.  
  1036.   Make sure that you are using a valid path for setserial, and a valid
  1037.   device name.  You can check the settings of a serial port by running:
  1038.  
  1039.        setserial -a /dev/ttyS3
  1040.  
  1041.   10.  Communications Programs And Utilities
  1042.  
  1043.   Here is a list of some communication software you can choose from,
  1044.   available via FTP, if they didn't come with your distribution.
  1045.  
  1046.   ╖  ecu - a communications program
  1047.  
  1048.   ╖  C-Kermit <http://www.columbia.edu/kermit/> - portable, scriptable,
  1049.      serial and TCP/IP communications including file transfer and
  1050.      character-set translation
  1051.  
  1052.   ╖  minicom - telix-like communications program
  1053.  
  1054.   ╖  procomm - procomm-like communications program with zmodem
  1055.  
  1056.   ╖  seyon - X based communication program
  1057.  
  1058.   ╖  xc - xcomm communication package
  1059.  
  1060.   ╖  Other useful programs are term and SLiRP.  They offer TCP/IP
  1061.      functionality using a shell account.
  1062.  
  1063.   ╖  screen is another multi-session program.  This one behaves like the
  1064.      virtual consoles.
  1065.  
  1066.   ╖  callback is a program that will have your modem call you back.
  1067.  
  1068.   ╖  mgetty+fax handles FAX stuff, and provides an alternate getty.
  1069.  
  1070.   ╖  ZyXEL is a control program for ZyXEL U-1496 modems.  It handles
  1071.      dialin, dialout, dial back security, FAXing, and voice mailbox
  1072.      functions.
  1073.  
  1074.   ╖  SLIP and PPP software can be found at
  1075.      ftp://sunsite.unc.edu/pub/Linux/system/network/serial.
  1076.  
  1077.   ╖  Other things can be found on
  1078.      ftp://sunsite.unc.edu/pub/Linux/system/serial and
  1079.      ftp://sunsite.unc.edu/pub/Linux/apps/comm or one of the many
  1080.      mirrors.  These are the directories where serial programs are kept.
  1081.  
  1082.   11.  Serial Tips And Miscellany
  1083.  
  1084.   Here are some serial tips you might find helpful...
  1085.  
  1086.   11.1.  kermit and zmodem
  1087.  
  1088.   To use zmodem with kermit, add the following to your .kermrc:
  1089.  
  1090.        define rz !rz < /dev/ttyS3 > /dev/ttyS3
  1091.        define sz !sz \%0 > /dev/ttyS3 < /dev/ttyS3
  1092.  
  1093.   Be sure to put in the correct port your modem is on.  Then, to use it,
  1094.   just type rz or sz <filename> at the kermit prompt.
  1095.  
  1096.   11.2.  Setting Terminal Types Automagically
  1097.  
  1098.   To set your terminal type automagically when you log in, add the
  1099.   terminal type to the entry in /etc/inittab.  If I have a vt100
  1100.   terminal on ttyS1, I would add ``vt100'' to the getty command:
  1101.  
  1102.        S1:456:respawn:/sbin/getty ttyS1 DT9600 vt100
  1103.  
  1104.   You can also use tset, which can establish terminal characteristics
  1105.   when you log in, and doesn't depend on any defaults.
  1106.  
  1107.   11.3.  Color ls On Serial Connections
  1108.  
  1109.   If ls is screwing up your terminal emulation with the color feature,
  1110.   turn it off.  ls --color, and ls --colour all use the color feature.
  1111.   Some installations have ls set to use color by default.  Check
  1112.   /etc/profile and /etc/csh.cshrc for ls aliases.  You can also alias ls
  1113.   to ls --no-color, if you don't want to change the system defaults.
  1114.  
  1115.   11.4.  Printing To A Printer Connected To A Terminal
  1116.  
  1117.   There is a program called vtprint, available from
  1118.   ftp://ftp.sdsu.edu/pub/vtprint, and from http://www.sdsu.edu/~garrett.
  1119.  
  1120.   Another program that will do this is called xprt.  It can be found at
  1121.   ftp://sunsite.unc.edu/pub/Linux/system/printing.
  1122.  
  1123.   11.5.  Can Linux Configure The Serial Devices Automagically?
  1124.  
  1125.   Yes.  To get Linux to detect and set up the serial devices
  1126.   automatically on startup, add the line:
  1127.  
  1128.        /sbin/setserial /dev/ttyS3 auto_irq skip_test autoconfig
  1129.  
  1130.   to your /etc/rc.d/rc.local or /etc/rc.d/rc.serial file.  Do this for
  1131.   every serial port you want to auto configure.  Be sure to give a
  1132.   device name that really does exist on your machine.
  1133.  
  1134.   11.5.1.  Notes For Multiport Boards
  1135.  
  1136.   For board addresses, and IRQs, look at the rc.serial that comes with
  1137.   the setserial program.  It has a lot of detail on multiport boards,
  1138.   including I/O addresses and device names.
  1139.  
  1140.   11.6.  Using A Serial Console
  1141.  
  1142.   There is an article in issue 36 of the Linux Journal,
  1143.   http://www.ssc.com/lj/issue36/index.html that explains how to use a
  1144.   serial console.  Unfortunately, email to the author bounces.  I hope
  1145.   that the article will be on the Linux Journal web site at the above
  1146.   URL soon.
  1147.   11.7.  Higher Serial Throughput
  1148.  
  1149.   If you are seeing slow throughput and serial port overruns on a system
  1150.   with (E)IDE disk drives, you can get hdparm.  This is a utility that
  1151.   can modify (E)IDE parameters, including unmasking other IRQs during a
  1152.   disk IRQ.  This will improve repsonsiveness and will help eliminate
  1153.   overruns.  Be sure to read the man page very carefully, since some
  1154.   drive/controller combinations don't like this and may corrupt the
  1155.   filesystem.
  1156.  
  1157.   Also have a look at a utility called irqtune that will change the IRQ
  1158.   priority of a device, for example the serial port that your modem is
  1159.   on.  This may improve the serial throughput on your system.  The
  1160.   irqtune FAQ is at http://www.best.com/~cae/irqtune.
  1161.  
  1162.   12.  One Step Further...
  1163.  
  1164.   This section is not required reading, but may give you some further
  1165.   insight into Unix, and the world of telecommunications.
  1166.  
  1167.   12.1.  What Are Lock Files?
  1168.  
  1169.   Lock file are simply a file saying that a particular device is in use.
  1170.   They are kept in /usr/spool/uucp, or /var/lock.  Linux lock files are
  1171.   named LCK..name, where name is either a device name, or a UUCP site
  1172.   name.  Certain processes create these locks so that they can have
  1173.   exclusive access to devices, for instance if you dial out on your
  1174.   modem, a lock will appear telling other processes that someone is
  1175.   using the modem already.  Locks mainly contain the PID of the process
  1176.   that has locked the device.  Most programs look at the lock, and try
  1177.   to determine if that lock is still valid by checking the process table
  1178.   for the process that has locked the device.  If the lock is found to
  1179.   be valid, the program (should) exit.  If not, some programs remove the
  1180.   stale lock, and use the device, creating their own lock in the
  1181.   process.  Other programs just exit and tell you that the device is in
  1182.   use.
  1183.  
  1184.   12.2.  ``baud'' Vs. ``bps''
  1185.  
  1186.   ``baud'' and ``bps'' are perhaps one of the most misused terms in the
  1187.   computing and telecommunications field.  Many people use these terms
  1188.   interchangeably, when in fact they are not!
  1189.  
  1190.      baud
  1191.         The baud rate is a measure of how many times per second a
  1192.         signal, for instance one sent by a modem (modulator-demodulator)
  1193.         changes. For example, a baud rate of 1200 implies one signal
  1194.         change every 833 microseconds. Common modem baud rates are 50,
  1195.         75, 110, 300, 600, 1200, and 2400. Most high speed modems run at
  1196.         2400 baud. Because of the bandwidth limitations on voice-grade
  1197.         phone lines, baud rates greater than 2400 are harder to achieve,
  1198.         and only work under very pristine phone line quality.  Multiple
  1199.         bits can be encoded per baud, to get bit rates that exceed the
  1200.         baud rate. ``baud'' is named after Emile Baudot, the inventor of
  1201.         the asynchronous telegraph printer.
  1202.  
  1203.      bps
  1204.         The bps rate is a measure of how many bits per second are
  1205.         transmitted.  Common modem bps rates are 50, 75, 110, 300, 1200,
  1206.         2400, 9600, ...  115200. Using modems with V.42bis compression
  1207.         (max 4:1 compression), theoretical rates up to 115200 bps are
  1208.         possible.  This is what most people mean when they misuse the
  1209.         word ``baud''.
  1210.  
  1211.   So, if high speed modems are running at 2400 baud, how can they send
  1212.   14400 bps?  The modems achive a bps rate greater than baud rate by
  1213.   encoding many bits in each signal change, or phase change. Thus, when
  1214.   2 or more bits are encoded per baud, the bps rate exceeds the baud
  1215.   rate. If your modem connects at 14400 bps, it's going to be sending 6
  1216.   bits per phase change, at 2400 baud.
  1217.  
  1218.   How did this confusion start? Well, back when low speed modems were
  1219.   high speed modems, the bps rate actually did equal the baud rate. One
  1220.   bit would be encoded per phase change. People would use bps and baud
  1221.   interchangeably, because they were the same number. For example, a 300
  1222.   bps modem also had a baud rate of 300. This all changed when faster
  1223.   modems came around, and the bit rate exceeded the baud rate.
  1224.  
  1225.   12.3.  What Are UARTs?  How Do They Affect Performance?
  1226.  
  1227.   UARTs (Universal Asyncronous Receiver Transmitter) are chips on your
  1228.   PC serial board.  Their purpose is to convert data to bits, send the
  1229.   bits down the serial line, and then rebuild the data again on the
  1230.   other end.  UARTs deal with data in byte sized pieces, which is
  1231.   conveniently also the size of ASCII characters.
  1232.  
  1233.   Say you have a terminal hooked up to your PC.  When you type a
  1234.   character, the terminal gives that character to it's transmitter (also
  1235.   a UART).  The transmitter sends that byte out onto the serial line,
  1236.   one bit at a time, at a specific rate.  On the PC end, the receiving
  1237.   UART takes all the bits and rebuilds the byte and puts it in a buffer.
  1238.  
  1239.   There are two different types of UARTs.  You have probably heard of
  1240.   dumb UARTs - the 8250 and 16450, and FIFO UARTs - the 16550A.  To
  1241.   understand their differences, first let's examine what happens when a
  1242.   UART has sent or received a byte.
  1243.  
  1244.   The UART itself can't do anything with the data, it just sends and
  1245.   receives it.  The CPU gets an interrupt from the serial device every
  1246.   time a byte has been sent or received.  The CPU then moves the
  1247.   received byte out of the UART's buffer and into memory somewhere, or
  1248.   gives the UART another byte to send. The 8250 and 16450 UARTs only
  1249.   have a 1 byte buffer.  That means, that every time 1 byte is sent or
  1250.   received, the CPU is interrupted.  At low rates, this is OK.  But, at
  1251.   high transfer rates, the CPU gets so busy dealing with the UART, that
  1252.   is doesn't have time to tend to other tasks.  In some cases, the CPU
  1253.   does not get around to servicing the interrupt in time, and the byte
  1254.   is overwritten, because they are coming in so fast.
  1255.  
  1256.   That's where the 16550A UARTs are useful.  These chips come with 16
  1257.   byte FIFOs.  This means that it can receive or transmit up to 16 bytes
  1258.   before it has to interrupt the CPU.  Not only can it wait, but the CPU
  1259.   then can transfer all 16 bytes at a time.  Although the interrupt
  1260.   threshold is seldom set at 16, this is still a significant advantage
  1261.   over the other UARTs, which only have the 1 byte buffer.  The CPU
  1262.   receives less interrupts, and is free to do other things.  Data is not
  1263.   lost, and everyone is happy.  (There is also a 16550 UART, but it is
  1264.   treated as a 16450 since it is broken.)
  1265.  
  1266.   In general, the 8250 and 16450 UARTs should be fine for speeds up to
  1267.   38400 bps.  At speeds greater than 38400 bps, you might start seeing
  1268.   data loss.  Other PC operating systems (definition used loosely here),
  1269.   like DOS aren't multitasking, so they might be able to cope better
  1270.   with 8250 or 16450s.  That's why some people don't see data loss,
  1271.   until they switch to Linux.
  1272.   Non-UART, and intelligent multiport boards use DSP chips to do
  1273.   additional buffering and control, thus relieving the CPU even more.
  1274.   For example, the Cyclades Cyclom, and Stallion EasyIO boards use a
  1275.   Cirrus Logic CD1400 RISC UART, and many boards use 80186 CPUs or even
  1276.   special RISC CPUs, to handle the serial I/O.
  1277.  
  1278.   Keep in mind that these dumb UART types are not bad, they just aren't
  1279.   good for high speeds.  You should have no problem connecting a
  1280.   terminal, or a mouse to these UARTs.  But, for a high speed modem, the
  1281.   16550A is definitely a must.
  1282.  
  1283.   You can buy serial boards with the 16550A UARTs for a little more
  1284.   money, just ask your dealer what type of UART is on the board.  Or if
  1285.   you want to upgrade your existing board, you can simply purchase
  1286.   16550A chips and replace your existing 16450 UARTs.  They are pin-to-
  1287.   pin compatible.  Some boards come with socketed UARTs for this
  1288.   purpose, if not you can solder.  Note that you'll probably save
  1289.   yourself a lot of trouble by just getting a new board, if you've got
  1290.   the money, they are under US$50.
  1291.  
  1292.   13.  Troubleshooting
  1293.  
  1294.   13.1.  I Keep Getting ``line NNN of inittab invalid''
  1295.  
  1296.   Make sure you are using the correct syntax for your version of init.
  1297.   The different init's that are out there use different syntax in the
  1298.   /etc/inittab file.  Make sure you are using the correct syntax for
  1299.   your version of getty.
  1300.  
  1301.   13.2.  When I Try To Dial Out, It Says ``/dev/cuaN: Device or resource
  1302.   busy''
  1303.  
  1304.   This problem can arise when DCD or DTR are not set correctly.  DCD
  1305.   should only be set when there is an actual connection (ie someone is
  1306.   dialed in), not when getty is watching the port.  Check to make sure
  1307.   that your modem is configured to only set DCD when there is a
  1308.   connection.  DTR should be set whenever something is using, or
  1309.   watching the line, like getty, kermit, or some other comm program.
  1310.  
  1311.   Another common cause of ``device busy'' errors, is that you set up
  1312.   your serial port with an interrupt already taken by something else.
  1313.   As each device initializes, it asks Linux for permission to use its
  1314.   hardware interrupt.  Linux keeps track of which interrupt is assigned
  1315.   to whom, and if your interrupt is already taken, your device won't be
  1316.   able to initialize properly.  The device really doesn't have much of
  1317.   any way to tell you that this happened, except that when you try to
  1318.   use it, it will return a ``device-busy'' error.  Check the interrupts
  1319.   on all of your boards (serial, ethernet, SCSI, etc.).  Look for IRQ
  1320.   conflicts.
  1321.  
  1322.   13.3.  I Keep Getting ``Id SN respawning too fast: disabled for 5 min¡
  1323.   utes''
  1324.  
  1325.   Make sure your modem is configured correctly.  Look at registers E and
  1326.   Q.  This can occur when your modem is chatting with getty.
  1327.  
  1328.   Make sure you are calling getty correctly from your /etc/inittab.
  1329.   Using the wrong syntax or device names will cause serious problems.
  1330.  
  1331.   Verify that your /etc/gettydefs syntax is correct by doing the
  1332.   following:
  1333.  
  1334.   linux# getty -c /etc/gettydefs
  1335.  
  1336.   This can also happen when the uugetty initialization is failing.  See
  1337.   section ``getty Or uugetty Still Doesn't Work''.
  1338.  
  1339.   13.4.  Serial Devices Are Slow, Or Serial Devices Can Only Send In One
  1340.   Direction
  1341.  
  1342.   You probably have an IRQ conflict.  Make sure there are no IRQs being
  1343.   shared.  Check all your boards (serial, ethernet, SCSI, etc...).  Make
  1344.   sure the jumper settings, and the setserial parameters are correct for
  1345.   all your serial devices.  Also check /proc/ioports and /proc/interrups
  1346.   for conflicts.
  1347.  
  1348.   13.5.  My Modem Is Hosed After Someone Hangs Up, Or uugetty doesn't
  1349.   respawn
  1350.  
  1351.   This can happen when your modem doesn't reset when DTR is dropped.  I
  1352.   saw my RD and SD LEDs go crazy when this happened to me.  You need to
  1353.   have your modem reset.  Most Hayes compatible modems do this with &D3,
  1354.   but on my USR Courier, I had to set &D2 and S13=1.  Check your modem
  1355.   manual.
  1356.  
  1357.   13.6.  I Have My Terminal Connected To My PC, But After I Type In A
  1358.   Login Name, It Just Locks Up
  1359.  
  1360.   ╖  If you are using getty: You probably don't have CLOCAL in your
  1361.      /etc/gettydefs entry for the terminal, and you're probably not
  1362.      using a full null modem cable.  You need CLOCAL, which tells Linux
  1363.      to ignore modem control signals.  Here is what it should look like:
  1364.  
  1365.        # 38400 bps Dumb Terminal entry
  1366.        DT38400# B38400 CS8 CLOCAL # B38400 SANE -ISTRIP CLOCAL #@S @L login: #DT38400
  1367.  
  1368.        # 19200 bps Dumb Terminal entry
  1369.        DT19200# B19200 CS8 CLOCAL # B19200 SANE -ISTRIP CLOCAL #@S @L login: #DT19200
  1370.  
  1371.        # 9600 bps Dumb Terminal entry
  1372.        DT9600# B9600 CS8 CLOCAL # B9600 SANE -ISTRIP CLOCAL #@S @L login: #DT9600
  1373.  
  1374.   Next, kill the getty process so a new one will be spawned with the new
  1375.   entry.
  1376.  
  1377.   ╖  If you are using agetty: Add the -L flag to the agetty line in your
  1378.      /etc/initab.  This will make it ignore modem control signals.  Then
  1379.      restart init by typing init q.  The entry should look like this:
  1380.  
  1381.        s1:345:respawn:/sbin/agetty -L 9600 ttyS1 vt100
  1382.  
  1383.   13.7.  At High Speeds, My Modem Looses Data
  1384.  
  1385.   If you are trying to run your modem faster than 38400 bps, and you
  1386.   don't have 16550A UARTs, you should upgrade them.  See section ``What
  1387.   Are UARTs?'' about UARTs.
  1388.  
  1389.   13.8.  On Startup, Linux Doesn't Report The Serial Devices The Way I
  1390.   Have Them Configured
  1391.  
  1392.   This is true.  Linux does not do any IRQ detection on startup, it only
  1393.   does serial device detection.  Thus, disregard what it says about the
  1394.   IRQ, because it's just assuming the standard IRQs.  This is done,
  1395.   because IRQ detection is unreliable, and can be fooled.
  1396.  
  1397.   So, even though I have my ttyS2 set at IRQ 5, I still see
  1398.  
  1399.        Jan 23 22:25:28 misfits vmunix: tty02 at 0x03e8 (irq = 4) is a 16550A
  1400.  
  1401.   when Linux boots.  You have to use setserial to tell Linux the IRQ you
  1402.   are using.  After Linux boots, you can look at the /proc/interrupts
  1403.   file, to see what IRQs are really configured.
  1404.  
  1405.   13.9.  rz And/Or sz Don't Work When I Call My Linux Box On A Modem
  1406.  
  1407.   If Linux looks for /dev/modem when you try to transfer files, look at
  1408.   /etc/profile, and /etc/csh.cshrc.  There are a bunch of aliases
  1409.   defined there on some distributions, most notably Slackware.  These
  1410.   aliases mess up the zmodem programs.  Take them out, or correct them.
  1411.  
  1412.   13.10.  My Screen Is Printing Funny Looking Characters
  1413.  
  1414.   This happens on virtual consoles when you send binary data to your
  1415.   screen, or sometimes on serial connections.  The way to fix this is to
  1416.   type echo ^v^[c.  For the control-character-impaired, thats:
  1417.  
  1418.        linux% echo <ctrl>v<esc>c
  1419.  
  1420.   13.11.  getty Or uugetty Still Doesn't Work
  1421.  
  1422.   There is a DEBUG option that comes with getty_ps.  Edit your config
  1423.   file /etc/conf.{uu}getty.ttySN and add DEBUG=NNN.  Where NNN is one of
  1424.   the following combination of numbers according to what you are trying
  1425.   to debug:
  1426.  
  1427.   D_OPT   001            option settings
  1428.   D_DEF   002            defaults file processing
  1429.   D_UTMP  004            utmp/wtmp processing
  1430.   D_INIT  010            line initialization (INIT)
  1431.   D_GTAB  020            gettytab file processing
  1432.   D_RUN   040            other runtime diagnostics
  1433.   D_RB    100            ringback debugging
  1434.   D_LOCK  200            uugetty lockfile processing
  1435.   D_SCH   400            schedule processing
  1436.   D_ALL   777            everything
  1437.  
  1438.   Setting DEBUG=010 is a good place to start.
  1439.  
  1440.   If you are running syslogd, debugging info will appear in your log
  1441.   files.  If you aren't running syslogd info will appear in
  1442.   /tmp/getty:ttySN for debugging getty and /tmp/uugetty:ttySN for
  1443.   uugetty, and in /var/adm/getty.log.  Look at the debugging info and
  1444.   see what is going on.  Most likely, you will need to tune some of the
  1445.   parameters in your config file, and reconfigure your modem.
  1446.  
  1447.   You could also try mgetty.  Some people have better luck with it.
  1448.  
  1449.   14.  Other Sources Of Information
  1450.  
  1451.   ╖  man pages for: agetty(8), getty(1m), gettydefs(5), init(1),
  1452.      login(1), mgetty(8), setserial(8)
  1453.  
  1454.   ╖  Your modem manual
  1455.  
  1456.   ╖  NET-3 HOWTO: all about networking, including SLIP, CSLIP, and PPP
  1457.  
  1458.   ╖  PPP HOWTO: help with PPP
  1459.  
  1460.   ╖  Printing HOWTO: for setting up a serial printer
  1461.  
  1462.   ╖  Term HOWTO: everything you wanted to know about the term program
  1463.  
  1464.   ╖  UPS HOWTO: setting up UPS boxen connected to your serial port
  1465.  
  1466.   ╖  UUCP HOWTO: for information on setting up UUCP
  1467.  
  1468.   ╖  Usenet newsgroups:
  1469.  
  1470.        comp.os.linux.answers
  1471.                FAQs, How-To's, READMEs, etc. about Linux.
  1472.        comp.os.linux.hardware
  1473.                Hardware compatibility with the Linux operating system.
  1474.        comp.os.linux.networking
  1475.                Networking and communications under Linux.
  1476.        comp.os.linux.setup
  1477.                Linux installation and system administration.
  1478.  
  1479.   ╖  The Linux serial mailing list.  To join, send email to
  1480.      majordomo@vger.rutgers.edu, with ``subscribe linux-serial'' in the
  1481.      message body.  If you send ``help'' in the message body, you get a
  1482.      help message.  The server also serves many other Linux lists.  Send
  1483.      the ``lists'' command for a list of mailing lists.
  1484.  
  1485.   ╖  A white paper discussing serial communications and multiport serial
  1486.      boards is available from Cyclades at http://www.cyclades.com.
  1487.  
  1488.   ╖  Modem FAQs:
  1489.      Navas 28800 Modem FAQ
  1490.      <http://web.aimnet.com/~jnavas/modem/faq.html>
  1491.      Curt's High Speed Modem Page
  1492.      <http://www.teleport.com/~curt/modems.html>
  1493.  
  1494.   ╖  Serial programming: Advanced Programming in the UNIX Environment
  1495.      <http://heg-
  1496.      school.aw.com/cseng/authors/stevens/advanced/advanced.nclk>, by W.
  1497.      Richard Stevens (ISBN 0-201-56317-7; Addison-Wesley)
  1498.      <http://www.ora.com/catalog/posix/> NAME="POSIX Programmer's
  1499.      Guide">, by Donald Lewine (ISBN 0-937175-73-0; O'Reilly)
  1500.  
  1501.   15.  Contributions
  1502.  
  1503.   There was no possible way to write this HOWTO alone.  Although a lot
  1504.   of the HOWTO is my writing, I have rewritten many contributions to
  1505.   maintain continuity in the writing style and flow.  Thanks to everyone
  1506.   who has contributed or commented, the list of people has gotten too
  1507.   long to list (somewhere over one hundred).  Special thanks to Ted T'so
  1508.   for answering questions about the serial drivers, Kris Gleason who
  1509.   used to maintain getty_ps, and Gert D÷ring who maintains mgetty.
  1510.  
  1511.   END OF SERIAL HOWTO
  1512.  
  1513.